Document the only_if_exists argument to gdk_atom_intern() as ignored.
authorMatthias Clasen <mclasen@redhat.com>
Fri, 23 Apr 2004 15:44:04 +0000 (15:44 +0000)
committerMatthias Clasen <matthiasc@src.gnome.org>
Fri, 23 Apr 2004 15:44:04 +0000 (15:44 +0000)
2004-04-23  Matthias Clasen  <mclasen@redhat.com>

* gdk/tmpl/properties.sgml: Document the only_if_exists argument
to gdk_atom_intern() as ignored.

docs/reference/ChangeLog
docs/reference/gdk/tmpl/properties.sgml

index 4186952ceceadd9fbc788f15fa3bef7f8389c04e..2b5326e1a15c97b9604f8c524543b9470e45deea 100644 (file)
@@ -1,3 +1,8 @@
+2004-04-23  Matthias Clasen  <mclasen@redhat.com>
+
+       * gdk/tmpl/properties.sgml: Document the only_if_exists argument
+       to gdk_atom_intern() as ignored.
+
 2004-04-21  Matthias Clasen  <mclasen@redhat.com>
 
        * gtk/gtk-sections.txt: Add GtkFileChooserEmbed to a 
index 9aac1ff75e33e8dfe83ffbf72fc343867a8ee24c..7cf46bd1afa27e4790e72b6012e02a611eedbceb 100644 (file)
@@ -225,11 +225,11 @@ Finds or creates an atom corresponding to a given string.
 </para>
 
 @atom_name: a string.
-@only_if_exists: if %TRUE, do not create a new atom, but
-                 just return the atom if it already exists.
-@Returns: the atom corresponding to @atom_name, or, if
-          @only_if_exists is %TRUE, and an atom does not
-          already exists for the string, %GDK_NONE.
+@only_if_exists: if %TRUE, GDK is allowed to not create a new atom, but
+                 just return %GDK_NONE if the requested atom doesn't already
+                 exists. Currently, the flag is ignored, since checking the 
+                 existance of an atom is as expensive as creating it.
+@Returns: the atom corresponding to @atom_name. 
 
 
 <!-- ##### FUNCTION gdk_atom_name ##### -->